###############################################################################
This file provides a guide to the code and data objects associated with 

Moore, Ryan T. “Overcoming Barriers to Heterogeneous-Group Learning in the Political Science Classroom”. PS: Political Science & Politics, 47(X):XX–XX, Forthcoming, 2014.

1 August 2014
###############################################################################


###############################################################################
Notes

1. The user should create a replication directory that includes four components:

  A. this file,
  B. a subdirectory /code/, which includes all .R files to create data and conduct analyses, and
  C. a subdirectory /data/, which includes data objects, and
  D. a subdirectory /figs/, into which some figures are put by default.

2. This collection of files replicates the paper, roughly by following the order of files below.

3. The code assumes that the R working directory is the directory which is one level above /code/ and /data/.  
###############################################################################


### Files that prepare data, perform analyses, and create plots: ###

1. replication.R
-- Loads data from class examples
-- Sources two functions stored /code/
-- Performs calculations reported in paper Sections 4 and 5
-- Creates plots in paper Sections 4 and 5

2. drawGroups.R
-- Creates data sets and calculates summary statistics for simulated examples of 24 students

3. evaluateLabs.R
-- Loads data and performs calculations for methodology class example in Section 5.3


### Data Objects ###
## Note: I recommend downloading these as .RData files to load(), using the 
##   Dataverse option ``Download as - Saved Original (R Data)’’, and placing
##   them in the /data/ directory.

1. class1.RData
-- Data from American politics class example

2. class2.RData
-- Data from methodology class example
